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CAUTION 


READ  THIS  MANUAL  COMPLETFJLY  BEFORE  YOU 
ATTEMPT  TO  INSTALL  THE  SYSTEM. 


associat=:d  documents 

Consult  the  lAS/RSX-U  FORTRAN  IV   User's   Guide   for   information   on 
using   the   system.    Consult   the   PDP-11   FORTRAN  Language  Reference 

the  FORTRAN  language  as  implemented   in   FORTRAN 


Manual  for  details 


IV. 


DOCUMENTATION  CONVENTIONS 
This  installation  guide  uses  the  following  documentation  conventions. 


ALTMODE 


•j 


CNTRL  Z 


MCR> 


underl ine 


The  symbol  $  represents  the 
nonprinting  ALTMODE  key.  When 
specified,  this  key  is  pressed  In 
place  of  the  RETURN  key.  Except 
where  ALTMODE  is  specified,  all 
commands  terminate  with  a  carriage 
return. 

The  notation  *Z  (where  Z  is  an 
alphabetic  character)  results  from 
pressing  the  ChlTRL  key  and  the 
appropriate  letter  simultaneously. 

Underlined  text  In  examples 
indicates  Information  printed  by 
the  system.  All  other  Information 
is  typed  by  the  user. 


CHAPTER  1 
INTRODUCTION 


This  manual  provides  complete  instructions  for  installing  FORTRAN  !V 
on  the  RSX-llM,  RSX-1 1"1-PLUS ,  IAS,  and  VAX/VMS  (under  AME)  operating 
systems. 

Read  all  the  chapters  relevant  to  your  operating  system  before  you 
attempt  to  install  FORTRAN. 


1.1   SYSTEM  RBQUIREMBNTS 

System  components  required  for  a  proper  installation  of  FORTRAN  IV 
depend  on  the  operating  system  on  which  the  distribution  kit  is  to  be 
instal led . 

The  component  requirements  for  the  RSX-llM,  RSX-1 IM-PLUS ,  IAS,  and 
VAX/VMS  (under  AME)  operating  systems  are  given  below. 


1.1.1   RSX-llM 

The  software  included  in   this   distribution   requires   the   following 
system  components  for  normal  use: 

•  RSX-llM  operating  system 

•  Minimum  8K  word  partition  for  compilation 

•  Minimum  275  blocks  of  contiguous  on-line  disk  storage  for   the 
compiler  task 

•  Minimum  175  blocks  of  on-line  disk  storage  for  the  Object  Time 
System  Library 

(Minimum  180  blocks  of  on-line  disk   storage   for   the   SYSLIB 
alone) 


1.1.2   RSX-UM-PLUS 

The  software  Included   in   the   distribution   requires   the   followi 
system  components  for  normal  use: 

•   RSX-llM-PLUS  operating  system 


,  nq 


Minimum  8K  word  partition  for  compllatlo 


n 
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•  Minimum  275  blocks  of  contiguous  on-line  disk  storaqe  for   the 
compiler  task 

*  sisterLibrary°'"'^  °^  on-line  disk  storaqe  for  the  Object  Time 

(Minimum  240  blocks  of  on-line  disk   storage   for   the   3YSLIB 
alone) 


1.1.3   IAS 

The  software  included   in   the   distribution   requires   the   foUowinq 
system  components  for  normal  use:  toxiowinq 

IAS  Operating  System 

Minimum  8K  word  partition  for  compilation 

Minimum  225  blocks  of  contiguous  on-line  disk  storage  for   the 
compiler  task  ^       '•^'* 

e   MinJ""'"',!!^  ^^"""^^   °^  on-line  disk  storage  for  the  Object  Time 
system  Library 

(Minimum  220  blocks  of  on-line  disk   storage   for   the   SYSLIB 
alone) 

The  installation  procedures  for  FORTRAN  under  IAS  depend  on  the 
operator  terminal  command  language  used  on  your  system.  if  vour 
?n^!T/f?^  '^?  ''''"  """"*"^  language.  consult  Chap-.er  4  fo  "^lis 
nstallation  instructions.  if  you.-  system  uses  the  OCL  command 
language,  consult  Chapter  5  for  IAS  installation  instructions. 


1.1.4   VAX/VMS  Uader  AME 

Iv;tim^co.'^nln^i'''•''  ^"   '"'"   distribution   requires   the   following 
syncem  components: 

•   VAX/VMS  Operating  System  with  AMp 

Minimum  8K  word  partition  for  compilation 

compTler^task''^"''""   °^   contiguous   on-line   disk   store   for 
ysterLib?arJ°'"'^  ""^   on-line  disk  storage  for  the  Object  Time 

(Minimum  370  blocks  of  on-line  disk   storage   for   the   SYSLIB 
ai one ) 


1.2   DISTRIBUTION  PI^IS 

The  FORTRAN  IV  software  kits  contalr  files  that  can  he  used  to  build  a 
FORTRAN  IV  system  on  HSX-llM.  RCX- I Im-plus ,  IAS,  or  VAX/VMS. 
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1.2.1   RSX-llM,  RSX-llM-PLUS,  or  IAS 

The  FORTRAN  IV  software  is  supplied  on  one  RKO 5 ,  RK06,  RK07,  RLOl,   or 
RL02  (not  IAS)  disk  cartridge  or  one  9-track  magnetic  tape. 

The  FORTRAN  IV  distribution  media  contain  the  following   compiler   and 
Object  Time  System  (GTS)  files: 


1.2.1.1  UPD  [11,411 


FOR.OLB 

FORBLD.ODL 

FORllM.ObL 

F0R11M.CMD 

F0R11U.CMD 

F0R11D.CMD 
FORIAS.CMD 


FORTRAN  compiler  object  module  library- 
Compiler  overlay  description  file  for  IAS 

Compiler  overlay  description  file  for  RSX-llM   and 
RSX-llM-PLUS 

Compiler  build  command   file   for   RSX-llM  mapped 
systems  and  RSX-llM-PLUS  systems 

Compiler  build  command  file  for   RSX-llN   unmapped 
systems 

Compiler  build  command  file  for  IAS  using  MCR 

Compiler  build  command  file  for  IAS  using  DCL 


1.2.1.2  UPD  [11,42] 
FOROTS.OBJ 
FORNHD.OBJ 

FOREAE.OBJ 

FOREIS.OBJ 

FORFIS.OBJ 

FORFPU.OBJ 

SHORT. OBJ 
NOVIR.OBJ 
VIRP.OBJ 
FCRTST.FTN 
FORRES. MAC 


OTS  «-cncatenated  object  modules 

OTS   concatenated   object  modules    specific   to 
no-optional  hardware  version 

OTS  concatenated  object  modules   specific   to   EAE 
version 

OTS  concatenated  object  modules   specific   to   EIS 
version 

OTS  concatenated  object  modules   specific   to   FIS 
version 

OTS  concatenated  object  modules   specific   to   FPP 
version 

OTS  short  error  text  module 

OTS  module  for  no  virtual  array  support 

OTS  module  for  virtual  array  support 

FORTRAN  test  program  for  verification  purposes 

OTS  resldent-libr/ -y  global  name  file 
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1.2.2   VAX/VMS 

The  FORTRAN  IV  software  is  supplied  on  three  RXOl  floppy  diskettes. 
This  kit  contains  the  following  compiler  and  Object  Time  System  (OTS) 
tiles:  J  ^         I 


1.2.2.1  Diskette  1 
VMS11MR1.COM 
FORVMS.CMD 
FORBLD.ODL 
EAE.OPT 
EIS.OPT 
FIS.OPT 
THR.OPT 
FORRES. MAC 
FORTST.FTN 


-  VMSllMRl 

Installation  command  file 

Compiler  build  command  file  for  VMS 

Compiler  overlay  description  file  for  VMS 

Parameter  file  for  in-line  EAE  option 

Parameter  file  for  in-lir.<s  EIS  option 

Parameter  file  for  in-line  FIS  option 

Parameter  file  for  threaded  THR  option 

OTS  resident  library  global  name  file 

FORTRAN  test  prograi  for  verification  purposes 


1.2.2.2  Diskette  2  -  VMSllPORA 


FOR.OLB 


FORTRAN  compiler  object  module  library 


1.2.2.3  Diskette  3  -  VMSllPORB 

FOROTS.OBJ     OTS  concatenated  object  modules 


FORNHD.OBJ 
FOREAE.OBJ 
FOREIS.OBJ 
rORPIS.OBJ 

FORFPU.OBJ 

SHORT. OBJ 
NOVIR.OBJ 
VIRP.OBJ 


OTS   concatenated   object  modules   specific   to 
no-optional  hardware  version 

OTS  concatenated  object  modules   specific   to  EAE 
version 

OTS  concatenated  object  modules   specific   to   EIS 
version 

OTS  concatenated  object  modules   specific   to   FIS 
version 

OTS  concatenated  object  modules   specific   to  FPU 
version 

OTS  short  error  text  module 

OTS  module  for  no  virtual  array  support 

OTS  "Module  for  virtual  array  support 
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CHAPTER  2 
INSTALLATION  PLANNING 


.»«■ 


This  Guide  covers  the  various  options  available  to  you  for  building 
the  FORTRAN  IV  system  and  tailoring  it  to  the  particular  needs  of  each 
installation.  This  chapter  presents  some  of  the  alternatives  you  must 
consider  before  you  start  the  installation  process. 


2.1   SELECTING  THE  •DEFAULT"  FORTRAN 

Those  installations  that  wish  to  run  both  FORTRAN  IV  (FOR)  and  FORTRAN 
IV-PLUS  (F4P)  on  the  same  system  must  determine  whether  FOR  or  F4P  is 
to  be  the  "default"  FORTRAN.  This  decision  must  be  made  for  two 
reasons: 


1. 


When  building  a  task,  object  modules  produced  by  the  FOR 
compiler  or  from  the  FOR  OTS  must  not  be  combined  with  object 
modules  produced  by  the  F4P  compiler  or  from  the  F4P  OTS. 


The   F4P   OTS   and   the 
object-module  library. 


FOR   OTS   cannot   be   in   the 


same 


Normally,  "the"  FORTRAN  OTS   is   part 
library,   [ 1 , 1 ) SYSLIB .OLB.    The   Task 
automatically  when  linkrng  a  task.   ic  ■  ' 
can  be  in  this  library. 


If 


of   the   system   object-module 

Builder   searches  this  library 

her  the  FOR  OTS  or  the  F4P   OTS 


your  installation  intends  to  use  both  FORTRAN  systems,  you  must 
build  a  separate  library  to  contain  one  of  the  Object  Time  Systems.  A 
programmer  must  name  this  library  explicitly  in  the  Task  Builder 
command  line  whenever  it  is  to  be  used.  The  Task  Builder  searches  the 
library  specified  in  the  command  line  before  searching  SYSLIB. 

When  you  make  this  choice  for  a  given  environment,  consider  which 
FORTRAN  should  be  slightly  easier  to  use  --  probably  the  one  that  will 
be  used  most  often.  The  system  whose  OTS  is  in  GYSLIB  will  not 
require  an  explicit  OTS  library  reference  at  task-build  time. 


2.1.1   Selecting  FORTRAN  IV  as  the  Default  FORTRAN 

If  you  select  FORTRAN  IV  as  the  default  FORTRAN,  you  can   continue 
use   a   previously   installed   FORTRAN  IV-PLUS  system  in  either  of 
ways.   Buiid  a  separate  library  containing  only  FORTRAN   IV-PLUS 
modules   (usually   [ 1 , 1 ) F4P0TS .OLB) ,  or  rename  the  current  SYSLIB. 


to 
two 
OTS 

If 


FORTRAN   IV-PLUS 


FORTRAN  IV-PLUS  has  not  been  installed,  refer  to  the   

Installation  Guide  for  procedures  to  include  its  OTS  in  a  separate  OTS 
Library. 
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2.1.2   Selecting  FORTRAN  IV-PLUS  as  the  Default  FORTRAN 

If  FORTRAN  IV-PLUS  is  to  be  the  default  FORTRAN,  follow  the  F4P 
installation  procedures  for  including  its  GTS  in  SYSLIB.  Then  carry 
out  the  instructions  to  build  a  separate  FORTRAN  IV  GTS  library. 


2.2   SELECTING  FORTRAN  IV  COMPILER  OPTIONS 

The  following  options  are  available  when  you  build  the  FORTRAN  IV 
compiler : 

1.  Specifying  listing-device  lines  per  page  for  installations 
using  non-U. S .-Standard  paper  stock. 

2,  Specifying  compiler  command  switch  default  settings  different 
from  the  DIGITAL-provided  defaults. 

3.  Specifying  the  amount  of  memory  used  for  compilation  in  a 
system-controlled  partition,  in  order  to  accommodate  the 
compilation  of  large  program  units. 

4,  Specifying  the  default  type  of  code  to  be  generated  by  the 
compiler  (in-line  or  threaded). 

A  programmer  can  edit  the  compiler  build  file  to  select  any  of  the 
above  options.  Documentation  within  the  file  describes  the  options 
available  and  any  limitations  on  choices  (see  Appendix  A). 


2.3   SELECTING  FORTRAN  IV  OTS  OPTIONS 

You  can  select  OTS  arithmetic  hardware  options  and  support  for  viitual 
arrays. 


2.3.1   Selecting  OTS  Arithmetic  Hardware  Options 

The  FORTRAN  IV  system,  as  supplied,  contains  components  for  support  of 
all  PDP-11  arithmetic  hardware  ootions.  You  must  generate  the  Object 
Time  System  to  conform  to  the  options  present  on  the  target  system. 
Choose  the  appropriate  file  from  Table  2-1  below.  Use  the  first  file 
in  the  list  that  is  appropriate  to  the  hardware  options  installed  on 
the  target  system.  If  new  hardware  options  are  added  to  the  system  at 
a  later  date,  a  programmer  can  rebuild  the  OTS  library  to  conform  to 
the  change. 


2.3.2   Selecting  VIRTUAL  Array  Support 

You  can  selec   VIRTUAL  array  support  as   an   option   on   systems   that 
support  the  memory  management  directives. 

1.  If  VIRTUAL  array  support  is  to  be  Included  In  the  OTS 
Library,  you  must  include  the  module  VIRP.OBJ  when  you  build 
the  library 

2,  If  the  target  system  does  not  support  the   memory   manaqenent 

Irectives,   you  must  include  the  module  NOVIR.OBJ  in  the  OTS 
Library. 


2-2 


INSTALLATION  PLANNING 


Table  2-1 
Hardware  Options  Required  for  OTS  Files 


Target  System 


PDP-11/70,11/60,11/55 
11/50,11/45,11/34 

PDP-11/40,11/35 

LSI-11 

PDP-11/70,11/60,11/55 

11/50,11/45,11/34; 
VAX/VMS  (under  AME) 

PDP-11/40,11/35 

Any 

Any 


Arithmetic  Hardware  Options 


FP11-A,FP11-B,FP11-C  floating- 
point processor 

KEll-F  floating  instruction  set 

KEVll  extended  arithmetic  chip 

No  floating-point  hardware 

(EIS  is  standard  on 
these  processors) 

KEll-E  extended  instruction  set 

KEll-A  or  KEll-B  extended 
arithmetic  element 

No  optional  arithmetic  hardware 


OTS  File 


FORFPU.OBJ 

FORFIS.OBJ 
FORFIS.OBJ 

FOREIS.03J 

FOREAE.OB,] 
FORNHD.OBJ 


2.4   INSTALLATION  PROCBDURBS 

If  you  are  installing  FORTRAN  IV  to  replace  an  earlier   version,   take 
the  following  preliminary  steps: 

1.  If  the  compiler  is  installed  in  the  RSX-lli«1,  RSX-1 IM-PLUS ,  or 
IAS  system,  remove  it: 

REM  ...FOR 

2.  Delete  the  following  files  from  the  system  disk: 

[1,501  FOR. TSK  on  Unmapped  RSX-lIM 

(1,541  FOR. TSK  on  "lapped  RSX-llM  or  RSX-1  IM-PLUS 

[11 ,11  FOR. TSK  on  IAS 

SYS$SYSTEM:FOR.EX?:  on  VAX/VMS 

3.  If  you  intend  to  incorporate  the  OTS  into  SYSLIB.OLB,  obtain 
a  fresh  copy  of  SYSLIB  from  the  operating  system  distribution 
kit.  OTS  modules  cannot  be  added  to  a  library  containing  a 
previous  version  of  the  OTS. 


NOTE 

The  FORTRAN  OTS  library  contains  224 (no 
VIRTUAL  support) /235(VIRTUAL  support) 
modules  and  fl25(no  VIRTUAL 
support) /922 (VIRTUAL  support)  entry 
points.  This  must  be  taken  into  account 
if  the  FORTRAN  OTS  is  going  to  be 
included  In  the  SYSLIB)  . 
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2.4.1   RSX-llM  and  RSX-llM-PLUS 

poptpam'tv'^^'^!'^  terminal  for  all  operations   you   use   to   build   the 
FORTRAN  IV  system. 

You  will  use  various  RSX-llM  utility  programs  to  build  the  FORTRAN   IV 

not  ?n;^.t}L    T^^m^i^l  '"  ""^'^   ""^""^^  ^^^^""^  ^^^^'^  the  utilities  are 
not  installed.   The  run  $xxx  command  is  shown: 

>RUN  $PIP 
RSX-lliJ°'''"^  directories   are   required   for   the  build   process   on 

[1,1],  [1,20],  [1,30],  [1,50],   for  unmapped  systems  on  RSX-llM 

icv^^'«^i^'Mo^  '  ^^'^^^'  tl'54],   for  mapped  systems  on  RSX-llM   or 
KaA— 1 1 M— PLUS 

YOU  must  create  any  directory  that  is  not  on  the  system  volume. 


2.4.2  IAS 

til   FoVRAN'jvS'ystl:'"*'"  '"''  "'"'  '"  "'    "P""'""   to   build 
The  following  directories  are  required  for  FORTRAN  iv  installation: 

[1,1]  ,  [11,1]  ,  [11,41] 
You  must  create  any  directory  that  is  not  on  the  system  volume. 

2.4.3  VAX/VMS 

Log  in  under  the  privileged  system  manager's  account. 

The  following  directories  are  required  for   FORTRAN   iv   installation- 
SYSSSYSTEM,  SYSSLIBRARY.  t«ix.tion. 
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CHAPTER  3 
INSTALLATIOM  ON  RSX-llM  AND  RSX-llM-PLUS 

This  chapter  covers  the  installation  procedures  required  for   RSX-liM 
Section   3.1   describes   the   installation   procedures  for  the  9-track 
magnetic  tape  distribution.   Section  3.2  describes   the   installation 

distribution     ''^^  ^^°^'      "'^°^'   ***^°^'  ^^°^'    °'    ^^°^   ^^^^  cartridge 
The  basic  installation  procedure  for  FORTRAN  IV  consis  s  of: 

1.  Building  the  FORTRAN  compiler   task   from   an   object   module 
library 

2.  Building  the  FORTRAN  Object  Time  System  liorary   from   obiect 
files  -" 

The  following  sections  provide  detailed  procedures. 
3.1   INSTALLATION  FROM  MAGTAPE  DISTRIBUTION 


3.1.1   Prapar-tions 


Mount  the  distribution  magtape  on  unit  0,  and  position  the  tape  at 
load  point.  If  the  magtape  handler  is  not  loaded,  make  it  available 
by  typing  the  following  command: 

>LOAD  MT: 

Note  that  the  device  code  for  some  9-track  magtape  units  is  MM-  if 
you  are  using  such  a  unit,  substitute  MM:  for  MT:  in  the  commands. 

For  RSX-llM-PLUS  only,  mount  the  magtape  by  typing: 

>MOU  MT0:/FOR 


• 


3.1.2  Building  tha  Coapilar 

J?«rliitlon\:dZl'"  '""  '"  "'"'"  -dul.-uor.ry  supplied  on  th. 
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3.1.2.1  RSX-llM  Unmapped  Systems  -  Type  the  following  commands  to 
transfer  the  required  files: 

>SET  /UIC=(1,20] 

£run  $FLX 

FLX>=MTO  :  [200,200]  FOR  .  OLB  ,  FORUM  .  ODL  ,  FORI  lU  .  CMD/DO 

FLX>"Z 

At  this  point  you  should  edit  the  compiler  task  build  command  file  to 
select  installation  options,  as  described  in  Appendix  A. 

Build  the  compiler  as  follows: 

>RUN  $TKB 

TKB>eFORllU 

TKB>''Z 

You  should  keep  the  compiler  object-module  library  on  your  system  so 
that  it  may  be  patched  with  PAT  should  a  patch  be  needed  in  the 
future. 

You  should  retain  the  edited  command  file  and  the  compiler  task-build 
map  for  future  reference. 


3.1.2.2  RSX-llM  and  RSX-llM-PLUS  Mapped  Systems  -  Type  the  following 
commands  to  transfer  the  required  files: 

>SET  /UIC»[1,24) 

>RUN  $FLX 

FLX>-MTO: [200,200] FOR. OLB , FORllM. ODL, FORllM. CMD/DO 

FLX>"Z 

At  this  point  you  should  edit  the  compiler  task-build  command  file  to 
select  installation  options  as  described  in  Appendix  A. 

Build  the  compiler  as  follows: 

FOR  RSX-llMl  FOR  RSX-llM-PLUS: 

>RUN  $TKB  ^RUN  STKBBIG 

TKB>§F0R11M  TKB>gFORllM 

TKB>*2  TKB>'Z 

You  should  keep  the  compiler  object-module  library  on  your  system  so 
that  it  may  be  patcheu  with  PAT  should  a  patch  be  needed  in  the 
future. 

You  should  retain  the  edited  cotrmand  file  and  the  compiler  task-build 
map  for  future  reference. 


3.1.3   Building  the  OTS 

Copy  the  required  OTS  files  from  the  magtape  to  the  system  disk. 

^SET  /UIC-(1,11 

^RUN  $FLX 

FLX>"MTO !  [ 200 , 200 ) FOROTS . OBJ , FOR  ?  ?  ? . OBJ , SHORT . OBJ , FORTST . FTN/DO 

FLX>-MT0 : ( 200 , 200 J  VIRP . OBJ , NOVI R . OBJ , FORRES . MAC/DO 

FLX>'2 

FOR777.0BJ  refers  to  OTS  arithmetic  hardware  options  as   described   in 
Section  2.3.1  and  Table  2-1. 
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in   SYSLIB,   type   the 
into  the  system  library 


If  you  have  decided  to  include  the  FORTRAN  GTS 
following  commands  to  add  the  FORTRAN  IV  OTS 
(please  read  Section  2.4  first) : 

>RUN  $LBR 

LBR>SYSLIB/RP=SHQRT 

LBR>SYSLIB/DG : $ERTXT/RP=FOROTS , FOR??? ,VIRP 

ENTRY  POINTS  DELETED; 

$ERTXT 

LBR>*Z 

If  you  decide  to  put  the  FORTRAN  IV  OTS  in  a   separate   library,   type 
the  following  commands  to  build  a  separate  FORTRAN  IV  OTS  library: 

>RUN  $LBR 

LBR>FOROTS/CR; :1024.=SHORT 

LBR>FOROTS/DG : $ERTXT=FOROTS , FOk??? ,VIRP 

ENTRY  POINTS  DELETED; 

$ERTXT 

.BR>''Z 


NOTE 

If  your  system  does  not  support  memory 
management  directives,  or  if  you  do  not 
want  VIRTUAL  array  support,  replace  VIRP 
with  NOVIR  in  the  above  command. 


3.2   INSTALLATION  FROM  DISK  CARTRIDGE 


3.2.1   Preparations 

Load  the  disk  handler  if  it  is  not  already  resident: 

>LOA  DK: 
Mount  the  volume: 

>MOU  DK0;FOR 


• 


3.2.2   Building  the  Compiler 

You  build  the  compiler  from  an  object-module  library  on  the 
distribution  disk.  Copy  the  co-npiler  build  files  from  the 
distribution  disk  to  the  system  disk  as  shown. 
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For  RSX-llM  unmapped  systems: 

>SET  /UIC=[1,201 

>RUN  $PIP 

PIP>=DKO : [11,41] FOR.OLB, FORI IM.ODL, F0R11U.CMD 

PIP>*Z 


For  RSX-llM  and  RSX-llM-PLUS  mapped  systems: 

>SET  /UIC-[1,241 

>RUN  $PIP 

PIP>»DKO:  1 1 1,4  HFOR.OLB,  FORI  iM.ODL,  F0R11M.CMD 

PIP>"Z 

At  this  point  you  should  edit  the  compiler  task  build  command  file 
(F0R11M.CMD  or  FORllU.CMD)  to  select  installation  options  as  described 
in  Appendix  A. 

Build  the  compiler  as  follows: 

For  RSX-llM  unmapped  systems: 

>RUN  $TKB 
TKB>  §FORHU 
TKB>  "Z 

For  RSX-llM  mapped  systems: 

>RUN  $TKB 
TKB>  §F0R11M 
TKB>  *Z 

For  RSX-llM-PLUS  systems: 

>RUN  3TKBBIG 

TKB>gFORllM 

TKB>*Z 

Save  a  copy  of  the  compiler  object  module  library  on  your  system  for 
patching  with  PAT  should  a  patch  be  needed  in  the  future.  You  should 
retain  the  edited  command  files  and  the  compiler  task  build  map  for 
future  reference. 


3.2.3   Building  the  OTS 

Copy  the  files  from  the  distribution  disk: 


>SET  /UIC-(1,11 

>RUN  $PIP 

PIP>-DKO; (11,421 FOROTS .OBJ , FOR??? , SHORT, FORTST. FTN , VI RP .OBJ ,NOVIR.OBJ 

PIP>«DKO :  (11,421  FORRES. MAC 


PIP>   Z 
>DR5  DKO: 
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FOR???. OBJ  refers  to  OTS  arithmetic  hardware  options  as  described  in 
Section  2.3.1  and  Table  2-1. 

If  you  have  decided  to  include  the  FORTRAN  IV  OTS  in  SYSLIB,  type  the 
following  commands  to  add  the  FORTRAN  IV  OTS  into  the  system  library 
(read  Section  2.4  first): 

>RUN  $LBR 
LBR>SYSLIB/RP=SHORT 

LBR>SySLIB/DG:$ERTXT/RP=FOROTS,FOR???,VIRP 
ENTRY  POINTS  DELETED; 
$ERTXT 
LBR>  *Z 


If  you  decide  to  put  the  FORTRAN  IV  OTS  in  a   separate   library,   ty 
the  following  commands  to  build  a  separate  FORTRAN  IV  OTS  library: 


^«* 


>SET  /UIC=[1,1) 

>RUN  $LBR 

LBR>FOROTS/CR; :1024.=SHORT 

LBR>F0ROTS/DG:$ERTXT='F0R0TS,FOR???,VIRP 

ENTRY  POINTS  DELETED; 

$ERTXT 

LBR>  ~Z 


NOTE 

If  your  system  does  not  support  the 
Memory  Management  Directives  or  if  you 
do  not  want  VIRTUAL  array  support, 
replace  VIRP  with  NOVIR  in  the  above 
command . 


3.3   INSTALLING  THE  COMPILBR 

You  install  the  FORTRAN  compiler  as  follows: 

RSX-llM  unmapped  ""systems: 

>INS  (1,50]FOR 
RSX-llM  and  RSX-llM-PLUS  mapped  systems; 

>INS  [l,54)FOR 
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CHAPTER  4 
INSTALLATION  ON  IAS  USING  MCR 


This  chapter  details  the  installation  procedures  required  for  IAS 
using  MCR.  Section  4.1  describes  the  installation  procedures  for  the 
9-track  magnetic  tape  distribution.  Section  4.2  describes  the 
installation  procedures  for  the  RK05,  RK0«5,  RK07-  or  RLOl  disk 
cartridge  distribution. 


The  basic  installation  procedure  for  FORTRAN  IV  consists  of: 

an  object  module 

2.   Building  a  FORTRAN  OTS  library  from  object  modules 


1.   Building  the  FORTRAN  compiler   task   from 
library  (be  sure  SLOTKB  is  installed) 


4.1   INSTALLATION  FROM  MAGTAPE  DISTRIBUTION 


4.1.1   Preparations 

Mount  the  distribution  magtape  on  unit  0,  and  position  it  at  load 
point.  If  the  magtape  handler  is  not  loaded,  make  it  available  by 
means  of  the  following  command: 

MCR>LOAD  MT 

Note  that  the  device  code  for  some  9-track  magtape  units  is  MM:.  If 
you  are  using  such  a  unit,  substitute  MM:  for  MT:  in  the  commands. 

Mount  the  magtape: 

MCR>MOU  MTO:/CHA»[FOR1 


4.1.2   Building  tha  Coapilar 

You  build  the  FORTRAN  compiler  from  an  object-module  library  supplied 
on  the  distribution  medium. 

Type  the  following  commands  to  transfer  the  required  files: 

MCR>FLX  (11,41)/RS»MT: ( 200 , 200) FOR .OLB , FORBLD.ODL ,FORl ID .CMD/DO 

At  this  point  you  should  edit  the  compiler  task-build  command  file 
P0R11D.CMD  to  select  installation  options  as  described  in  Section  2  2 
and  Appendix  A. 
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Build  the  compiler: 

MCjOSTB  §[11,41]F0R11D 

You  should  retain  the  compiler  object  module  library  on  your  system 
for  patching  with  PAT  should  a  patch  be  needed  in  the  future.  You 
should  also  retain  the  edited  command  file  and  the  compiler  task  build 
map  for  future  reference. 


4.1.3  Building  the  OTS 

Copy  the  required  OTS  files  from  the  magtape  to  the  system  disk: 

M£R>FLX  -MTO: [ 200 , 200] FOROTS .OBJ , FOR??? .OBJ/DO 

MCR. FLX  -MTO: [ 200 ,200] SHORT. OBJ ,FORTST .FTN ,NOVIR. OBJ , FORRES .MAC/DO 

FOR???'. OBJ  refers  to  OTS  arithmetic  hardware  options  as  described  in 
Section  2.3.1  and  Table  2-1. 

If  you  have  decided  to  include  FORTRAN  IV  in  the  system  library,  type 
the  following  commands  to  add  the  FORTRAN  IV  OTS  into  the  system 
library  (read  Section  2.4  first): 

MCR>LBR  SYSLIB/RP-SHORT 

MCR>LBR  SYSLIB/DG:$ERTXT/RP»FOROTS,FOR???,VIRP 

ENTRY  POINTS  DELETED: 

$ERTXT 

MCR> 

If  you  decide  to  put  the  FORTRAN  IV  OTS  into  a  separate  library,  type 
th«  following  commands  to  build  a  separate  FORTRAN  IV  OTS  library: 

HCR>LBR  FOROTS/CR: : 1024. -SHORT 

mcr>lbr  forots/dg:$ertxt-for0ts,f0r???,virp 
Entry  points  deleted; 

$ERTXT 
MCR> 


NOTE 

If  your  system  does  not  support  memory 
management  directives,  or  if  you  do  not 
want  VIRTUAL  array  support,  replace  VIRP 
with  NOVIR  in  the  above  command 
sequence. 


4.2   INSTALLATION  PROM  DISK  CARTRIDGE  DISTRIBUTION 

Th«  following  sections  describe  the  instal  lat  io'n   procedures   required 

for   the   disk   cartridge   distr  ib.«t  ion.   Tf  the  system  disk  is  not  an 

RK05,  RK06,  RK07  or  RLOl  ,  place  the  d i str inut ion  disk  in  drive  0.   If 

th«   system  disk  is  an  RK05,  RX06,  RK07,  or  RLOI,  use 

svstem  disk  and  drive  1  for  the   distribution   disk. 

these   two  configurations  are  the  same;   only  the  unit 

diffsrsnt. 


drive  0  for 

Procedures 
assignments 


the 

for 
are 
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In  the  following  directions  the  designation  OKO :  refers  to  the  unit  on 
which  the  FORTRAN  distribution  pack  is  placed.  For  each  step  use 
DKO :  or  DKl:  for  the  RK05  distribution.  Use  DM0:  or  DM1:  for  the 
RK06  or  RK07  distribution.  Use  DLO :  or  DLl :  for  the  RLOl 
distribution. 


4.2.1   Preparations 

Place  the  distribution  disk  in  drive  0,  wr ite- locked .  Load  the  disk 
handler  task,  if  it  is  not  already  resident,  by  means  of  the  following 
command : 

MCR>LOAD  DK 

Mount  the  volume: 

MCR>MOU  OKO: FOR 


4.2.2   Building  the  Coapiler 

You  build  the  compiler  from  an  object  module  library  ->..pplied  on  the 
distribution  medium. 

Type  the  following  commands  to  transfer  the  required  files: 

'iCR>PIP  [11  ,411  »DK0:FQR.OLB,FORBLD.ODL,  F0R11D.CMD 

At  this  time  you  should  edit  the  compiler  task-build  command  file 
FOR110.CMD  to  select  Installation  options  as  described  in  Section  2.2 
and  Appendix  A. 

Build  the  compiler: 

MCR>TKB  #[11 ,41)F0R11D 

You  ^^hould  retain  the  compiler  object  module  library  on  your  system 
for  patching  with  PAT  should  a  patch  be  needed  In  the  future.  You 
should  also  retain  the  edited  command  file  and  the  compiler  task  build 
map  for  future  reference. 


4.2.3   Building  the  GTS 

Copy  the  required  OTS  files  from  the  FORTRAN  distribution  disk  to  the 
system  disk: 

MCR>PIP  "DKO : (U ,42) FOROTS.OBJ ,FOR??? ,SHORT,FORTST. FTN,VIRP.OBJ 

FOR???. OBJ  refers  to  OTS  arithemetlc  hardware  options  as  described  in 
Section  2.3.1  and  Table  2-1. 

If  you  havt  decided  to  Include  FOPTRAN  IV  in  the  system  library,  type 
the  following  commands  to  build  the  FORTRAN  IV  OTS  Into  the  system 
library  (read  Se^^tlon  2.4  first): 

MCR>LBR  SYSLIB/RP-SHORT 

MCR>LBR  SYSLIB/DG:SERTXT/RP-FOROTS,FOR???,VIRP 

ENTRY  POINTS  DELETED: 

$ERTXT 

MCR> 
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If  you  decide  to  put  FORTRAN   IV   in   a   separate   library,   type 
following  comri.ands  to  build  a  separate  FORTRAN  IV  OTS  library: 

MCR>LBR  FOROTS/CR: :1024.=SHORT 

MCR>LBR  FOROTS/DG : $ERTXT=FOROTS , FOR??? ,VIRP 

ENTRY  POINTS  DELETED; 

$ERTXT 

MCR> 


the 


NOTE 

If  your  system  does  not  support  memory 
management  directives,  or  if  you  do  not 
want  VIRTUAL  array  support,  replace  VIRP 
with  NOVIR  in  the  above  command 
sequence. 


4.3   INST'   ING  THE  COMPILER 
You  install  the  FORTRAN  compiler  as  follows: 
MCR>INS  [11,11F0R 


• 
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CHAPTER  5 
INSTALLATION  ON  IAS  USIKG  DCL 


This  chapter  details  the  installation  procedure^  required  for  IAS. 
Section  5.1  describes  the  installation  procedures  for  the  9-track 
magnetic  tape  distribution.  Section  5.2  describes  the  installation 
procedures  for  the  disk  cartridge  distribution. 

The  basic  installation  procedure  for  FORTRAN  IV  consists  of: 

1.  Building  the  FORTRAN   compiler   task   from  an   object-module 
library  (be  sure  SLOTKB  is  installed) 

2.  Building  the  FORTRAN  OTS  library  from  object  modules 


5.1   INSTALLATION  PROM  MAGTAPB  DISTRIBUTION 


5.1.1  Pr«parations 

Mount  the  distribution  magtape  on  unit  0,  and  posiMon  the  tape  at 
load  point.  Note  tJat  the  device  code  for  some  9-  rack  magtape  units 
is  MM:.  If  you  are  using  such  a  unit,  replace  MTO :  with  MMO :  in  the 
commands. 

Load  the  magtape  handler  task,  if  it  is  not  resident,  with  the 
command: 

SCI> RUN/HANDLER  MT 

Mount  the  volume: 

PDS>  MOUNT/FOREIGN  »1T0 :  FOR 


5.1.2  Building  th«  Conpiler 

You  build  the  FORTRAN  compiler  from  an  object-module  library   supplied 
on  the  distribution  medium. 

Copy  the  needed  files  from  the  magtape  to  the  system  disk: 

PDS>  SET  DEFAULT  (11,411 

COPY  MTO:  [200,2001  FOR. OLB/DOS  *.* 

COPY  MTO: (200, 2001 FORBLD. DDL/DOS  *.* 

COPY  MTO: (200,200) FORIAS.CMD/DOS  *.* 
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At  this  point  you  should  edit  the  compiler  task-build  command  file, 
FORIAS.CMD,  to  select  installation  options  as  described  in  Section  2.2 
and  Appendix  A. 

Build  the  compiler: 

PDS>  @FORIAS 

You  should  retain  the  compiler  object-module  library  on  your  system 
for  patching  with  PAT  should  a  patch  be  needed  in  the  future.  You 
should  also  keep  the  edited  command  file  and  the  compiler  task-build 
map  for  future  reference. 


5.1.3   Building  the  OTS 

Copy  the  required  OTS  files  from  the  magtape  to  the  system  disk: 

PDS>  SET  DEFAULT  [1,1] 

PDS>  COPY  *1T0:  [200, 200]*. OBJ/DOS  *.* 
PDS>  COPY  MTO: [200,200]FORTST.FTN/DOS  *.* 
PDS>  COPY  MTO:  [200,  200]  FORRES.  *1AC/D0S  *.* 

FOR???   refers  to  OTS  arithemetic  hardware   options   as   described 
Section  2.3.1  and  Table  2-1. 


in 


If  you  have  decided  to  include  the  FORTRAN  OTS  in  SYGLIB,  type  the 
following  commands  to  build  the  FORTRAN  IV  OTS  into  the  system  library 
(read  Section  2.4  first): 

PDS>  LIB  INSERT  SY6LIB  SHORT 

PDS>  LIB  DELETE/GLOBAL  SYSLIB  SERTXT 

ENTRY  POINTS  DELETED: 

SERTXT 

PDS>  LIB  INSERT  SYSLIB  FOROTS  FOR???  VIRP 

If  you  decide  to  put  FORTRAN  IV  in  a  separate  library,  type  the 
following  commands  to  build  a  separate  FORTRAN  IV  OTS  library: 

PDS>  LIB  CREATE/EPT: 1024  FOROTS  SHORT 

PDS>  LIB  DELETE/GLOBAL  FOROTS  $ERTXT 

ENTRY  POINTS  DELETED: 

SERTXT 

PDS>  LIB  INSERT  FOROTS  FOROTS  FOR???  VIRP 


NOTE 

If  your  system  does  not  support  memory 
management  directives,  or  if  you  do  not 
want  VIRTUAL  array  support,  replace  VIRP 
with  NOVIR  in  the  above  command. 


5.2   INSTALLATION  FROM  DISK  CARTRIDGE  DISTRIBUTION 


The  following  sections  describe  the  installation   procedures   required 
for   the   disk   cartridge   distribution.   If  the  system  disk  is  not  an 


RK05,  RK06,  RK07,  or  RLOl,  place  the  distiibution  disk 
the   system   disk  is  an  RK05,  RK06.  RKO?.  or  RLOl,  use 
system  disk  and  drive  1  for  the   distribution   disk. 
these   two  configurations  are  the  same;   only  the  unit 
different. 


in  drive  0  .  If 

drive  0  for  the 

Procedures  for 

assignments  are 
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In  the  directions  which  follow,  the  designation  DKO :  refers  to  the 
unit  on  which  the  FORTRAN  distribution  pack  is  placed.  For  each  step 
use  DKO:  or  DKl:  for  the  RK05  distribution.  Use  DM0:  or  DM1:  for 
the  RK06  or  RK07  distribution.  Use  DLO :  or  DLl :  for  the  RLOl 
distribution. 


5.2.1   Preparations 

Place  the  distribution  disk  in  drive  0,  wr i te-locked.   Load   the   disk 
handler  task,  if  it  is  not  resident,  with  the  following  command: 

SCI>  RUN/HANDLER  DK 

Mount  the  volume: 

PDS>  MOUNT  DKO :  FOR 


5.2.2   Building  the  Conpiler 

You  build  the  compiler  from  an  object  module  library  supplied  on  the 
distribution  medium. 

Type  the  following  commands  to  transfer  the  required  files: 

PDS>  SET  DEFAULT[11,411 

PDS>  COPY  DKO :  [11  ,411 *.*  *.* 

PDS>  DEL  F0R11U.CMD;* 

PDS>  DEL  F0R11M.CMD;* 
Ppg>  DEL  F0R11D.CMD;* 

At  this  time  you  should  edit  the  compiler  task-build  command  file 
FORIAS.CMD  to  select  installation  options  as  described  in  Section  2.2 
and  Appendix  A. 

Build  the  compiler: 

PDS>  «FORIAS 

You  should  retain  the  compiler  object  module  library  on  your  system 
for  patching  with  PAT  should  a  patch  be  needed  in  the  future.  You 
should  also  keep  the  edited  command  file  and  the  compiler  task-builder 
map  for  future  reference. 


• 


5.2.3   Building  the  OTS 

Copy  the  required  OTS  files  from  the  FORTRAN  distribution  disk  to   the 
system  disk: 

PDS>  SET  DEFAULT  (1,11 

PDS>  COPY  DKO : (11,421 *.*  *.♦ 

FOR???   refers  to  OTS  arithmetic   hardware   options   as  described   in 
Section  2.3.1  and  Table  2-1. 
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If  you  Tiave  decided  to  include  the  FORTRAN  OTS  in  SYSLIB,  type  the 
following  commands  to  add  the  FORTRAN  IV  OTS  into  the  system  library 
(read  Section  2.4  first): 

PDS>  LIB  INSERT  SYSLIB  SHORT 

PDS>  LIB  DRLETE/GLOBAL  SYSLIB  SERTXT 

ENTRY  POINVS  DELETED; 

SERTXT 

PDS>  LIB  INSERT  SYSLIB  FOROTS  FOR???  VIRP 

If  you  decide  to  put  FORTRAN  IV  into  a  separate  library,  type  the 
following  commands  to  build  a  separate  FORTRAN  IV  OTS  library: 

PDS>  LIB  CREATE/EPT: 1024  FOROTS  SHORT 

PDS>  LIB  DELETE/GLOBAL  FOROTS  SERTXT 

ENTRY  POINTS  DELETED; 

SERTXT 

PDS>  LIB  INSERT  FOROTS  FOROTS  FOR???  VIRP 


NOTE 

If  your  system  does  not  support  memory 
management  directives,  or  if  you  do  not 
want  VIRTUAL  array  support,  replace  VIRP 
with  NOVIR  in  the  above  commands. 


5.3   INSTALLING  THE  COMPILER 

You  install  the  FORTRAN  compiler  as  follows; 
PDS>  INSTALL  [11,1) FOR 


NOTE 

You  must  install  FORTRAN  IV  as  task 
"...FOR"  on  IAS.  If  FORTRAN  IV-PLUS  is 
already  installed  under  that  name, 
remove  it  and  reinstall  it  as  task 
"...F4P"  before  proceeding. 
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CHAPTER  6 
INSTALLATION  ON  VAX/VMS  UNDER  AMC 


Before  beginning  this  installation  procedure,  note  that  some  of  the 
hardware  options  provided  for  both  the  compiler  and  the  OTS  library  do 
not  exist  on  VAX/V^S  under  the  RSX-llM  compatibility  mode;  see  Table 
2-1.  You  may  use  these  particular  options  only  for  the  purpose  of 
downline  loading  to  a  PDP-11  RSX-llM  target  system. 

To  prepare  for  installation  of  FORTRAN   IV   on   VAX/VMS   {under   AME) 
proceed  as  follows: 

•  Be  sure  logical  name  SYSSDISK  is  assigned  to  the  disk  that 
contains  the  current  version  of  VAX/VMS,  as  distributed, 
containing  all  updates.  This  disk  also  contains  the  command 
procedure  that  initiates  the  new  installation/  update 
procedure.  Note  that  SYSSoiSK  need  not  be  (and  If  possible 
should  not  be)  SYSSSYSTEM. 

•  Set  defaults  as: 

UIC  (1,41 


directory  [SYSUPD] 
Set  these  defaults  in  the  order 
At  the  console  terminal,  type 


shown , 


aVMSUPDATE 
You  will  see  the  followi 


ng  message  text  at  the  terminal 


This  command  procedure   performs   VAX/VMS 
unbundled  software  installations 


software   updates   and 


During  this  sequence,  the  standard  console   floppy   will   not   be 
present  in  the  console  floppy  drive.  


Therefore,  the  system  is  vulnerable  to   power   failure   or   other 
fatal  crash.   if  a  system  crash  shouH  occur  during  tihis  Ume  th 


update  sequence  can  be  restarted  at  t 
incomplete  update.  ~~ 


he  beginning   of   the   first 


Dismount  the  current  console  fli 


i££^, 


Please  place  the  first  floppy  of  the  kit  In  the  console  dri 


ve 


Note  that  you  will  receive  a  device-not- 


mounted  mesoage  if  there  is 


no 


floppy   diskette  mounted.    Ignore   this  message  and  place  your  first 
diskette,  labeled  F4/VAX  VMSllMRl,  In  the  diskette  drive. 
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AS  you  remove  the  standard  diskette,  note  the  direction  it  is  facing. 
diskettes  from  the  distribution  kit  must  be  inserted  in  the  drive  s^ 
disketJe!)     ""'  direction.   (The  label  is  on  the  front  side  o^  th^ 

N«xt  you  will  receive  the  following  query: 
ARE  YOU  READY  TO  CONTINUE? 

If  you  type  N,  the  request  to  put  the  first  kit  diskette  in  the 
console  floppy  drive  and  the  query  are  repeated.  If  you  type  Y  the 
installation  proceeds  to  copy  the  compiler-build  command  files  and  to 
select  compiler  code  options: 

What  kind  of  code  generation  is  desired? 
Enter  one  of  the  codes  shown  oelow: 

Code  Option 

THR  Threaded  -  hardware  independent 

EAE  Inline  (Extended  Arithmetic  Element) 

BIS  Inline  (Extended  Instruction  Set) 

PIS  Inline  (Floating  Instruction  Set) 
In  VAX-U  compatibility  mode,  the  only  form  of  in-line  code  support  is 

Any  other  response  causes  the  following  message  to  appear: 

i2X^^^^  ^^^^^  ^°^    ^^^^   option,  please  reenter  one  of 
(THR,  EAE.  EIS,  FISi^ — 

After  this  phase  is  completed,  you  receive  the  message: 

Please  put  the  second  floppy  disk  (VMSllFQRA)  in  the  drive. 

Are  you  ready  to  continue? 

tiprY''''The'Ln^'!'°''^  '"  ''*  ^''^•-   ^'*"  ^°^  *^«  ^"^V  to  proceed, 
type  Y.   The  following  message  appears: 

yx!L^°!"fi.^''  "ui'^-'Ml^'^'y  """^^       ^^   ^°^^^^   ^"d  ^^"^       compiler 
•   task-built.   This  will  take  approximately  20  mlF^UtTT 

Completion  of  these  procedures  is  Indicated  by  the  message: 

Please  put  the  third  floppy  disk  (V>lSilFORB)  In  the  drive. 

Are  you  ready  to  continue? 

Place  diskette   VMSllFOW   In   the   drive.    when   you   are   re-dv   to 
continue,  type  Y.   You  will  now  be  queried  about  OTS  options. 


• 
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OTS  options  in-'lude: 
1. 


OTS  Listing  -  The  FORTRAN  IV  OTS  can  either  be  generated  as  a 
separate  library: 

rSYSLIBl FOROTS.OLB 

or  be  included  in  the  standard  VAX/VMS  RSX-llM  system 
1 ibrary: 

[SYSLIBISYSLIB.OLB 

If  you  intend  to  incorporate  the  OTS  into  SYSLIB.OLB,  obtain 
a  fresh  copy  of  SYSLIB  from  che  operating  system  distribution 
kit.  OTS  modules  cannot  be  added  to  a  library  containing  a 
previous  version  of  the  OTS. 


NOTE 

The  FORTRAN  OTS  library  contains  224  (no 
VIRTUAL  support)  /235 (VIRTUAL  support) 
modules  and  825  (no  VIRTUAL  support) 
/922  (VIRTUAL  support)  e.try  points. 


Do  you  want  the  OTS  included  in  SYSLIB.OLB? 

If  you  want  the  OTS  to  be  in  the  standard   library, 
if  you  want  it  to  be  a  separate  library,  type  N. 


type   Y; 


Installations  that  wish  to  conserve  main  memory,  and  that 
have  many  FORTRAN  programs,  will  find  it  useful  to  build  a 
FORTRAN  IV  OTS  resident  library.  A  MACRO-11  source  file 
(FORRES. i^AC)  is  included  as  part  of  the  distribution  kit  to 
help  in  this  regarc.  FORRES. MAC  is  located  on  diskette 
VMSllMRl,  in  directory  [SYSUPDl .  This  file  contains  global 
references  to  all  modt-les  of  the  OTS  and  documentation  on 
logical  groups  of  OTS  modules. 

Refer  to  the  RSX-llM  Task  Builder  Reference  Manual  (Order  No, 
AA-2588D-TC) 


for   information 
shareable  library. 


on   building   a   FORTRAN   OTS 


r 


2.   Hardware  Configuration  -  The  following  messages  in(  cate  that 

ou   must   choose   a   hardware  configuration  from  a.iong  those 
isted: 

The  FORTRAN  IV  OTS  can  be   configured   for   any   of   the 
following  hardware  options: 

HND  -  No  specific  hardware 

EAE  -  EAE  hardware 

EIS  -  EIS  hardware 

FIS  -  FIS  hardware 

FPU  -  FPU  hardware 

Please   enter   the   three-character   mnemonic   tor    th» 
desired  hardware.   What  OTS  hardware  option  do  you  want? 
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If  you  respond  with  anything  except  one  of   these   codes   you 
will  receive  the  message: 

Invalid  value  for  t"  "*  s  option,   please   re-enter   one  of 
(NHD,  EAR,  EIS,  FIS,  PPU) . 

VAX-11   compatibili     •'ode   supports  NHD,    EIS,    or    FPU 
configurations.   Pie*  '^•-  refer  to  Table  2-1  for  selection. 

As  the  OTS  is  being  configured,  you  will  receive  the  message: 

The  entry  point  SERTXT  will  be  deleted  as  part  of  the  OTS 
build. 

This  message  requires  no  response.   It  is  informational  only. 

3.  VIRTUAL  array  option  -  VIRTUAL  arrays  are  supported  on 
systems  that  suppot  memory  management  di recti ves-- that  is, 
on  target  RSX-llM  systems.   You   can   include  VIRTUAL   array 

support  by  responding  Y  to  the  query: 

Do  you  want  VIRTUAL  array  support  ir  the  OTS? 

Respond  N  if  you  do  not  want  this  option. 

Finally,  you  are  asked,  as  follows,  to  indicate  whether   you   want   to 
delete  any  previous  versions  of  FORTRAN  IV: 

This  procedure  created  new  versions  of  the   FORTRAN   IV   compiler 
and  OTST 

You  can  keep  or  delete  older  versi  ns. 

Do  you  want  to  delete  older  versions? 

To  retain  previous  versions,  type  M;   to  delete  them,  type  Y. 
This  completes  the  installation  of  FORTRAN  IV.   You  will  receive: 

ARE  THERE  MORE  KITS  TO  PROCESS?   [Y/Nl 

Your  reply  should  be  H;      the  following  message  will  then  appear: 

Please  place  the  system  console  floppy  in  the  console  drive. 

You  should  immediately  restore  the  standard  console  diskette   to   the 
console  drive.   Next,  you  will  receive  the  following  query: 

ARE  YOU  READY  TO  CONTINUE? 

If  you  type  Y,  the  console  floppy  diskette   is   automatically  mounted 
and  you  receive  the  following  message: 


Requested  update  sequence  is  complete. 

Finally,  after  installing,  you  should  back  up  the  volume  SYSSDISK   and 
save  the  original  for  future  updates. 


f-4 


CHAPTER  7 
SYSTEM  BUILD  VERIFICATION 


The  FORTRAN  IV  kit  includes  a  test  program  (FORTST.FTN)  to  verify 
proper  operation  of  the  installed  system.  The  execution  of  this 
program  is  self-explanatory. 


7.1   RSX-llM  AND  RSX-llM-PLUS  SYSTEMS 

If  the  FORTRAN  IV  OTS  is  part  of  SYSLIB,  type  the  following  commands: 

>SET  /UIC=[1,1] 
>FOR  FORTST=FORTST 
>RUN  $TKB 
TKB>FORTST=FORTST 
TKB>// 
>RUN  FORTST 

If  the  EAE  version  is  used  with  FORTRAN  IV  as  the  default,  replace  the 
command  TKB>FORTST= FORTST  with  the  command  TKB>FORTST/EA= FORTST. 

If  the  FPP  version  is  used  with  FORTRAN  IV  as  the  default,  replace  the 
command  TKB>FORTST=FORTST  with  the  command  TKB>FORTST/FP=FORTST. 

If  the  FORTRAN  IV  OTS  is  in  a  separate  library,  type  the  following 
commands: 

>SET  /UIC=[1,11 

>FOR  FORTST'FORTST 

>RUN  $TKB 

TK B>FORTST= FORTST. FOROTS/ LB 

TKB>// 

>RUN  FORTST 

If  the  EAE  version  is  used  with  a  separate  OTS  library,  replace  the 
command  TK B> FORTST* FORTST. FOROTS/LB  with  the  command 
TKB>FORTST/EA=FORTST,FOROTS/LB. 

If  the  FPP  version  is  used  with  a  separate  OTS  library,  replace  the 
command  TKB>FORTST=FORTST,FOROTS/LB  with  the  command 
TKB>FORTST/FP=FORTST , FOROTS/LB . 

If  the  test  does  not  execute  successfully,  check  for  an  error  in  the 
installation.  Correct  the  error  by  rebuilding  the  compiler  or  OTS  as 
necessary. 
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7.2   IAS  USING  HCR 


If  the  FORTRAN  IV  OTS  is  part  of  SYSLIB,  type  the  following  commands 
to  run  the  verification  test  {  $  represents  the  altmode  or  escape 
key)  : 

MCR>SET  /UIC=[1,11 
MCR>FOR  FORTST=FORTST 
MCR>TKB  FORTST=FORTST 
MCR>RUN  FORTST  $ 


type   the   following 


If  the  FORTRAN  IV  OTS   is   a   separate   library, 
commands  to  perform  the  verification: 

MCR>SET  /UIC«[1,11 

MCR>FOR  FORTST-FORTST 

MCR>TKB  FORTST»FORTST,FOROTS/LB 

MCR>RUN  FORTST  $ 

If  the  test  does  not  compile  and  execute  correctly,  check  for  a 
possible  installation  error.  Correct  the  problem  by  rebuilding  the 
compiler  or  OTS  as  necessary. 


7.3   IAS  USING  DCL 

If  the  FORTRAN  IV  OTS  is  part  of  SYSLIB,  type  the  following  commands 
to  run  the  verification  test: 

PDS>  PORTRAN/FOR/NOLIST  FORTST 
PDS>  LINK  FORTST 
PDS>  RUN  FORTST 

If  the  FORTRAN  IV  OTS  is  a  separate  library,  type  the  following 
commands  to  perform  the  verification: 

PDS>>  FORTRAN/FOR/NOLIST  FORTST 
PDS>  LINK  FORTST  FOROTS/LIB 
PDS>  RUN  FORTST 

If  the  test  does  not  execute  successfully,  check  for  an  installation 
error.  Correct  the  error  by  rebuilding  the  compiler  or  OTS  as 
required . 


7.4   VAX/VMS  UNDER  AME 

The  FORTRAN  IV  kit  includes  a  test  program,  FORTST. FTN,  to  verify 
proper  operation  of  the  installed  system.  The  execution  of  this 
program  is  self-explanatory. 

If  the  FORTRAN  IV  OTS  is  part  of  SYSLIB,  type  the  following  commands: 

I  MCR  FOR  FORTST-FORTST 
I  MCR  TKB  FORTST-FORTST 
$  RUN  FORTST 
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If  the  FORTRAN 
commands: 


IV  OTS  is  in  a  separate   library,   type   the   following 


$  MCR  FOR  FORTST=FORTST 

i  MCR  TKB  FORTST=FORTST, [SYSLIB] FOROTS/LB 
S  RUN  FORTST 


If  the  test  does  not  execute  successfully,  check  for  an  error  in  the 
installation.  Correct  the  error  by  rebuilding  the  compiler  or  OTS  as 
necessary. 
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COMPILER  BUILD  PILE  LISTINGS 


This  appendix  presents  sample  listings  of  the  compiler-build  files  for 
the  following  systems:  RSX-llM  (mapped  and  unmapped) ,  RSX-1 IM-PLUS, 
IAS  (using  MCR  and  DCL) ,  and  VAX/VMS  under  AME.  These  listings  are 
useful  in  the  selection  of  compiler  options  and  for  editing  purposes. 
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A.l   RSX-llM  -  UNNAPPEO 

l»505FOR/-CP/  MM»C1»30]F0R/-SF=C1,201F0R11M/Mr 

FORTRAN  IV  COMPILER  TASK  BUILD  FliF. 

FOR  V02.5»  RSX-llh  DNMAF'FED  SYSTFMS 

TASK  NAME 
ASK=. . .FOR 

BUILD  FOR  PARTITION  GEN»  WHICH  MUST  Bf  AT  LEAST  8K 
PAR- GEN 

SP  STACK  SIZE 

STACK  MUST  BE  AT  LEA?;  I  150  WORDS 

STACK=150 

COMPILER  LOGICAL  UNIT  ASSIGNMENTS 

1  -  COMMAND  INPUT 

2  -  COMMAND  OUTPUT 

3  -  .OBJ  OUfPUT 

4  -  .LST  OUTPUT 

5  .FTN  INPUT 

INITS«5 
ASG^Ti:i:2 

TASK  SIZE  FOR  SYSTEM  CONTROLLED  PARTITIONS 

THE  FOLLOWING  EXTTSK  SETS  THE  COMPILER  DEFAULT  SIZE  TO  BK  WORDS. 

nl    rJ^^nnf£.r?^!^^'^^^^    ^^    REQUIRED,  THE  EXTTSK  MAY  BE  INCREASED* 
OR  THE  COMPILER  MAY  BE  INSTALLED  WITH  THE  /EXTEND  SWITCH. 

XTTSK»iOOO 

NUMBER  OF  LINES  PER  LISTING  PAGE 

THE  FOLLOWING  GBLPAT  CONTROLS  THE  NUMBER  OF  LINES  PER  LISTING  PAGE. 

THE  VALUE  SPECIFIED  FOR  THE  PATCH  IS  THE  NUMBER  OF  LINES 

PER  PAGE  DESIRED.  MINUS  I. 

DEFAULT  VALUE  IS  000070(8)  -  56.  -  57.  LINES  PER  PAGE. 

GBL  PAT' FROOT : tLNMAX : 000070 

DEFAULT  SWITCH  SETTINGS  (SWITCH  WORD  1) 

THE  GLBPAT  WHUM  FOllOWS  ALLOWS  THE  DEFAULT  SWITCH  SETTINGS  TOR 
THE  COMPIIER  TO  Bf  SET.   THI  VALUF  SPECIFIED  FOR  THF  FATCH  IS 
THE  LOGICAL  OR  OF  THE  INDIVIDUAL  SWITCH  SETTINGS  DESIRED. 


# 


• 
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i   syiTCH 

i       NAME 
LI 


SWITCH 
SETTING 


VALUE  TO  "OK"  INTO  PATCH 


/Li:sR'c  </Li:i)  00000 1 

/li:map  (/li:2)  000002 

/LI : COD  K/LllA)  000004 

/li:all  (/1 1:7)  000007 

/-LI  000000 


LISTING  OF  SOURCE  F-ROGRAM 
LISTING  OF  STORAGE  MAP 
LISTING  OF  GENERATED  CODE 


0000:>0   GENERATr  READ -ONLY  PSECTS 
000000 


000000   STATEMENT  TRACE  ON  ERRORS 
000200 

000400   ACCEPT  80  COLS.  OF  INPUT 
000000    (RATHER  THAN  72  +  SEQ  FIELD) 

001000   SPOOL  Li."^TING  OUTPUT 
000000 

002000   ENABLE  DIAGNOSTIC  MODE  FOR 
000000    COMPILER  CRASHES 

004000   ALLOCATE  2  WORDS  TO  INTEGER 
000000    WARS  BY  DEFAULT 

020000   COMPILE  DEBUG  LINES 
000000 

000000   VECTOR  ARRAYS 
040000 

000000   PRINT  WARNING  DIAGNOSTICS 
100000 

THE  VALUE  CALCULATED  FOR  THE  OPTIONS  DESIRED  MUST  BE  'OR'ED  WITH 
000040(8)  TO  YIELD  THE  VALUE  FOR  THE  PATCH  (I.E.r  THE  40(8)  BIT 
MUST  BE  SET  IN  THE  ♦SIDEF  WORD). 

THE  DEFAULT  VALUE*  001043(8) f  IS  THE  EQUIVALENT  OF: 
/Li:3/-R0/SN/-EX/SP/-DI/-I4/-DE/VA/WR 

OBLPAT-FROOT : fSlDEF : 001041 

DEFAIiLT  SWI-'JH  SETTINGS  (SWITCH  WORD  2) 

THE  GLBPAT  WHICH  FOLLOWS  ALLOWS  THE  DEFAULT  SWITCH  SETTINGS  FOR 
THE  COMPILER  TO  BE  SET.   THE  VALUE  SPECIFIED  FOR  THE  PATCH  IS 
THE  LOGICAL  OR  OF  THE  INDIVIDUAL  SWITCH  SETTINGS  DESIRED. 


RO 

/RO 

/-RO 

SN 

/SN 

/-SN 

EX 

/EX 

/-EX 

SP 

/SP 

/-SP 

DI 

/DI 

14 

/I4 

/-I4 

DE 

/DE 

/-DE 

VA 

/VA 

/-VA 

UR 

/WR 

/-WR 
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i    SUITCH 
NAME 


CD 


LO 


SUITCH 
SETTING 


/cd:thr 
/cd:eae 
/cd:eis 
/cd:fis 


/LO 
/-LO 


VALUE  TO  'OR*  INTO  PATCH 


000000  GENERATE  THREADED  CODE 

000002  GENERATE  EAE  INLINE  CODE 

000004  GENERATE  EIS  INLINE  CODE 

000014  GENERATE  FIS+EIS  INLINE  CODE 

000000  LOG  PROGRAM  UNIT  NAMES  ON  TERMINAL 

040000  DO  NOT  LOG  PROG  NAMES  ON  TERMINAL 


THE  VALUE  CALCULATED  FOR  THE  OPTIONS  DESIRED  MUST  BE  'OR'ED  WITH 

SnoJ^Si®^  ^°  ^^^^^'  ^"^  '^^^"^  ^°^    T"E  f^'^TCH  (I.E.,  THE  017700<8)  BITS 
MUST  BE  SET  IN  THE  ♦S20EF  WORD). 


;  THE  DEFAULT  VALUE*  017700(8),  IS  THE  EQUIVALENT  OF  J 

I      /cd:thr/lo 
i 

GBLPAT=FR00T : ♦S2DEF : 01 7700 

// 
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A. 2   RSX-lirt  AND  RSX-llM-PLUS  -  MAPPED 

C1»543F0R/-CFVMM,C1,34  3F0R/MA/CR/-SP=C1»24:F0R11M/MP 
) 

f    FORTRAN  IV  COMPILER  TASK  BUILD  FILE 

f 

i    FOR  V02.5»  MAPPED  RSX-llM  AND  RSX-llM  PLUS  SYSTEMS 

} 

i 

i    TASK  NAME 

i 

TASK=., .FOR 

f 

»  BUILD  FOR  PARTITION  GENf  WHICH  MUST  BE  AT  LEAST  8K 

ft 

» 
PAR=GEN 

i    SP  STACK  SIZE 

*  STACK  MUST  BE  AT  LEAST  150  U0RD3 

» 

STACK=150 

I  COMPILER  LOGICAL  UNIT  ASSIGNMENTS 

) 

»         1  -  COMMAND  INPUT 

»        2  -  COMMAND  OUTPUT 

i  3  -  .OBJ  OUTPUT 

i  4  -  .LST  OUTPUT 

i  5  -  .FTN  INPUT 

i 

UNITS«5 

ASG=Ti:i:2 

} 

I  TASK  SIZE  FOR  SYSTEM  CONTROLLED  PARTITIONS 

t 

i    THE  FOLLOWING  EXTTSK  SETS  THE  COMPILER  DEFAULT  SIZE  TO  8K  WORDS. 

i    IF  A  LARGER  COMPILER  IS  REQUIRED.  THE  EXTTSK  MAY  BE  INCREASED. 

t    OR  THE  COMPILER  MAY  BE  INSTALLED  WITH  THE  /INC  SWITCH. 

ft 

I 
EXTTSK=1000 

»  NUMBER  OF  LINES  PER  LISTING  PAGE 

»  THE  FOLLOWING  GBLPAT  CONTROLS  THE  NUMBER  OF  LINES  PER  LISTING  PAGE. 

i    THE  ^^ALUE  SPECIFIED  FOR  THE  PATCH  IS  THE  NUMBER  OF  LINES 

;  PER  PAGE  DESIRED.  MINU3  1. 

i    DEFAULT  VALUE  IS  000070(8)  *  56.  =  57.  LINES  PER  PAGE. 

i 

GBLPAT=FROOT : iLNMAX : 0000 /O 
i 

»  DEFAULT  SWITCH  SETTINGS  (SWITCH  WORD  1) 
) 

i  THE  GLBPAT  WHICH  FOLLOWS  ALLOWS  THE  DEFAULT  SWITCH  SETTINGS  FOR 

I  THE  COMPILER  TO  BE  SET.   TML  VAl  UE  SPECIFIED  FOR  THE  PATCH  IS 

»  THE  LOGICAL  OR  OF  THE  INDTVIDIJAL  SWITCH  SETTINGS  DESIRED. 
) 
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COMPILER  BUILD  PILE  LISTINGS 


SWITCH 
NAHE 


LI 


SWITCH 
SETTING 


VALUE  TO  -OR-  INTO  PATCH 


/LI : SRC  (/Li:i)  000001 

/LI : MAP  (/Li:2)  000002 

/LItCOD  </Li:4)  000004 

/li:all  (/li:7)  ooooo? 

/~LI  000000 


listing  of  SOURCE  PROGRAM 
listing  of  STORAGE  MAP 
LISTING  OF  GENERATED  CODE 


RO 

/RO 

/-RO 

SN 

/SN 

/-SN 

EX 

/EX 

/-EX 

8P 

/SP 

/-SP 

OZ 

/Dl 

Z4 

/I4 

/-I4 

01 

/DE 

/-DE 

VA 

/VA 

/-VA 

Ml 

/WR 

/-WR 

000020   GENERATE  READ-ONLY  PSECTS 
000000 

000000   STATEMENT  TRACE  ON  ERRORS 
000200 

000400   ACCEPT  80  COLS.  OF  INPUT 
000000    (RATHER  THAN  72  +  SEO  FIELD) 

001000   SPOOL  LISTING  OUTPUT 
000000 

002000   ENABLE  DIAGNOSTIC  MOt   FOR 
000000    COMPILER  CRASHES 

004000   ALLOCATE  2  WORDS  TO  INTEGER 
000000    WARS  BY  DEFAULT 

020000   COMPILE  DEBUG  LINES 
000000 

000000   VECTOR  ARRAYS 
040000 

000000   PRINT  WARNING  DIAGNOSTICS 
100000 

I!!L^*'""^  CALCULATED  FOR  THE  OPTIONS  DESIRED  MUST  BE  'ORTn  uttm 

THE  DEFAULT  VALUE,  001043(8),  IS  THE  EQUIVALENT  OF: 
/Li:3/-R0/SN/-EX/SP/-DI/-I4/-DE/VA/WR 

OBLPAT-FROOT : tSl DEF : 001 043 

DEFAULT  SWITCH  SETTINGS  (SWITCH  WORD  2) 

THE  ?oJ!P?LErj§^E°SF?"'  ?L'°!;!  '"'  '''^""'-'  ^"^^^"  ^^^^I^GS  '^0'* 
Tuc  .noTJ.!:.     °  *^  ^^^'       ^"^  ^f^iME    SPECIFIED  FOR  THE  PATCH  IS 
THE  LOGICAL  OR  OF  THE  INDIVIDUAL  SWITCH  SETTINGS  DESIRED 


A-*; 


COMPILER  BUILD  PILE  LISTINGS 


SWITCH 
NAME 


CO 


LO 


SWITCH 
SETTING 


/cd:thr 

/CDJEAE 

/cd:eis 
/cd:fis 


/LO 
/-LO 


VALUE  TO  •OR-  INTO  PATCH 


000000 
000002 
000004 
000014 


GENERATE  THREADED  CODE 
GENERATE  EAE  INLINE  CODE 
GENERATE  EIS  INLINE  CODE 
GENERATE  FIS+EIS  INLINE  CODE 


000000   LOG  PROGRAM  UNIT  NAMES  ON  TERMINAL 
040000   DO  NOT  LOG  PROG  NAMES  ON  TERMINAL 


THE  VALUE  CALCULATED  FOR  THE  OPTIONS  DESIRED  MUST  BE  'OR'ED  UITH 
017700(8)  TO  YIELD  THE  VALUE  FOR  THE  PATCH  (I.E.,  THE  017700(8)  BITS 
MUST  BE  SET  IN  THE  ♦S2DEF  WORD). 

THE  DEFAULT  VALUE,  017700(8),  IS  THE  flQUIVALENT  OF: 

/cd:thr/lo 

GBLPAT=FR00T : ♦S2DEF  t  01 7700 
// 
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COMPILER  BUILD  PILE  LISTINGS 


A. 3   IAS  USING  NCR 

C  1 1 , 1  3F0R/CF' »  C  1 1 , 4 1  3F0R/-SP=C  1 1 ,  4nF0RBLD/MP 

; 

i    FORTRAN  IV  COMPILER  TASK  BUILD  FILE 

* 

t 

*  FOP  V02.5.  IAS  SYSTEMS  USING  MCR 

i 

i  TASK  NrtrtE 
TASK^,  .FOR 
i    LINK  TO  SYSTEM  RESIDENT  LIBRARY 

f 

libr«sysrfs;ro 

f 

5  BUIUD  FOR  PARTITION  GEN,  WHICH  MUST  BE  AT  LEAST  8K 

i 

PAROGEN 

i 

i    SP  STACK  SIZr 

»  STACK  MUST  BL  AT  LEAST  150  WORDS 

t 

STACK-150 

i 

i  COMPILER  LOGICAL  'JNIT  ASSIGNMENTS 

f 

»        1  -  COMMAND  INPUT 

•  2  -  COMMAND  OUTPUV 
i        3  -  .OBJ  OUTPUT 

I        A    -    .LST  OUTPUT 

•  5  -  ,KTN  INPUT 
> 

UNITS«3 

ASG«Ti:i:2 

f 

»  TASK  SIZE  FOR  SYSTEM  CONTROLLED  PARTITIONS 

i    THE  FOLLOWING  EXTT3K  SETS  THE  COMPILER  DEFAULT  SIZE  TO  PK  WORDS. 
»  IF  A  LARGER  COMPILER  IS  REQUIRED.  THE  EXTTSK  MA/  BE  INCREASED* 
i    OR  THE  COMPILER  MAY  BE  INSTALLED  WITH  THE  /INC  SWITCH. 

EXTTSK»4500 
I 

»  NUMBER  OF  LINES  PER  LISTING  PAGE 

»  THE  FOLLOWING  GBLPAT  CONTROLS  THE  NUMBER  OF  LIKES  FTR  LISTING  PAGE. 

I  THE  VALUE  SPECIFIED  FOR  THE  PATCH  IS  THE  NUMBER  OF  LINES 

»  PER  PAGE  DESIRED.  MINUS  I, 

»  DEFAULT  VALUE  IS  000070(8 >  =  54.  =  57.  LINES  PER  PAGE. 

OBLPAT-FROOT  .'  ♦LNMAX  :  000070 

I 

I  DEFAULT  SWITCH  SETTINGS  (SWITCH  WORD  1) 

i    THE  GLBPAT  WHICH  FOLLOWS  ALl OWS  THE  DEFAULT  SWITCH  SETTINGS  FOR 
J  THE  COMPILER  TO  BE  SET.   THE  VALUE  SfTCIFIED  FOR  THE  PATCH  IS 
I  THE  LOGICAL  OR  OF  THE  INDIVIDUAL  SWITCH  SETTINGS  DESIRED. 


A- 8 


COMPILER  BUILD  FILE  LISTIHGS 


NAHC 
LI 


i    SWITCH 

i 
I 
I 
I 
♦ 
I 
» 
I 
» 

I 

i 

I 

I 

» 

I 

I 

> 

I 

I 

I 

I 

I 

» 

I 

I 

I 

I 


VA 

WR 


SWITCH 
SETTING 


VALUE  TO  "OR"  INTO  PATCH 


tx 


91 
14 


/LI : SRC  (/Li:i)  000001  listing  of  source  program 

/li:map  (/li:2)  000002  listing  of  storage  map 

/LItCOD  </Li:4)  000004  LISTING  OF  GENERATED  CODE 

/LI {ALL  (/Li:7)  000007 


/-LI 

/RG 
/-RO 

/SN 
/-SN 

/EX 
/-EX 

/SP 
/-SP 

/DI 


/I4 
/-I4 

/DC 
/-DE 

/VA 
/-WA 

/WR 
/-WR 


000000 

000020   GENERATE  READ-ONLY  PSECTS 
000000 

000000   STATEMENT  TRACE  ON  ERRORS 
000200 

000400   ACCEPT  80  COLS.  OF  INPUT 
000000    (RATHER  THAN  72  f  SEQ  FIELD) 

001000   SPOOL  LISTING  OUTPUT 
000000 

002000   ENABLE  DIAGNOSTIC  MODE  FOR 
000000    COMPILER  CRASHES 

004000   ALLOCATE  2  WORDS  TO  INTEGER 
000000    VARS  BY  DEFAULT 

020000   COMPILE  DEBUG  LINES 
000000 

000000   VECTOR  ARRAYS 
040000 

000000   PRINT  WARNING  DIAGNOSTICS 
100000 


THE  VALUE  CALCULATED  FOR  THE  OPTIONS  DESIRED  MUST  BE  'OR'ED  WITH 
000040(8)  TO  YIELD  THE  VALUE  FOR  THE  PATCH  (I.E.,  THE  40(8)  BIT 
MUST  BF  SET  IN  THE  tSlDEF  WORD). 

THE  DEFAULT  VALUEr  001043(8) »  IS  THE  EQUIVALENT  OF: 

i      /li:3/-r0/sn/-ex/sp/-di/-i4/-de/va/wr 
gblpat»froot:«sidef;ooio43 

»  default  SWITCH  SETTINGS  (SWITCH  WORD  2) 

I  THE  GLBPAT  WHICH  FOLLOWS  ALLOWS  THE  DEFAULT  SWITCH  SETTINGS  FOR 
I  THE  COMPILER  TO  BE  SET.   THE  VALUE  SPECIFIED  FOR  THE  PATCH  IS 
I  THE  LOGICAL  OR  OF  THE  INDIVir'UAL  SWITCH  SETTINGS  DESIRED. 
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COMPILER  BUILD  FILE  LISTINGS 


SWITCH 
NAME 

SWITCH 
SETTING 

CD 

/CDtTHR 

/cd;eae 
/cd:eis 
/cd:fis 

LO 

/LO 
/-LO 

VALUE  TO  •OR"  INTO  PATCH 

000000  GENERATE  THREADED  CODE 

000002  GENERATE  EAE  INLINE  CODE 

000004  GENERATE  EIS  INLINE  CODE 

000014  GENERATE  FIS+EIS  INLINE  CODE 

000000   LOG  PROGRAM  UNIT  NAMES  ON  TERMINAL 
040000   DO  NOT  LOG  PROG  NAMES  ON  TERMINAL 

I?'^^!!^';^^  CALCULATED  FOR  THE  OPTIONS  DESIRED  MUST  BE  'OR'ED  WITH 

SisTSr^ET^^iN^^;;?  ;SIdeTw"o%dT  ^"^  '^''^ ''-'-  -^  T..ZtVl.s 

THE  DEFAULT  VALUEr  017700(8) r  IS  THE  EQUIVALENT  OF! 

GBLPAT-FROOT :  $S2DEF  .*  01 7700 
/ 
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COMPILER  BUILD  FILE  LISTINGS 


A. 4   IAS  USING  DCL 

LINK/MU/L  ARGE/OVE :  C  1 1 . 4 1  DFORBLD/OPT/TASK  t  C 1 1 , 1  3F0R/MAP ICIUAI  DFOK/NOFLO 
I  FORTRAN  IV  COMPILER  TASK  BUILD  FILE 

i 

i    FOR  V02.5.  IAS  SYSTEMS  USING  DCL 

I 

t    TASK  NAME 

) 

TASKS... FOR 

i 

i  link  to  system  resident  library 

libr>sysres:ro 
i 

i    BUILD  FOR  PARTITION  GEN,  WHICH  MUST  BE  AT  LEAST  8K 
PAROGEN 

i  SP  STACK  SIZE 

»  STACK  MUST  BE  AT  LEAST  150  WORDS 

I 

STACK- ISO 

I 

I  COMPILER  LOGICAL  UNIT  ASSIGNMENTS 

> 

•  1  -  COMMAND  INPUT 

•  2  -  COMMAND  OUTPUT 

•  3  -  .OBJ  OUTPUT 

•  4    -    .LST  OUTPUT 
I        5  -  .FTN  INPUT 

f 
UNITS-S 

AS6-Ti:i:2 
I 

I  TASK  SIZE  FOR  SYSTEM  CONTROLLED  PARTITIONS 
f 

»  THE  FOLLOWING  EXTTSK  SETS  THE  COMPILER  DEFAULT  SIZE  TO  8K  WORDS. 
i    IF  A  LARGER  COMPILER  IS  REQUIRED,  THE  EXTTSK  MAY  BE  INCREASED, 
»  OR  THE  COMPILER  MAY  BE  INSTALLED  WITH  THE  /INC  SWITCH. 

EXTTSK-4500 
I 

I  NUMBER  OF  LINES  PER  LISTING  PAGE 
I 

I  THE  FOLLOWING  GBLPAT  CONTROLS  THE  NUMBER  OF  LINES  PER  LISTING  PAGE. 

>  THE  VALUE  SPECIFIED  FOR  THE  PATCH  IS  THE  NUMBER  OF  LINES 

I  PER  PAGE  DESIRED,  MINUS  1. 

»  DEFAULT  VALUE  IS  000070(8)  =  56.  =  57.  LINES  PEf  PAGE. 

GBLPAT-FROOT : tLNMAX : 000070 

I 

I  DEFAULT  SWITCH  SETTINGS  (SWITCH  WORD  1) 

t  THE  GLBPAT  WHICH  FOLLOWS  ALLOWS  THE  DEFAULT  SWITCH  SETTINGS  FOR 

t  THE  COMPILER  TO  BE  SET.   THE  VALUE  SPECIFIED  FOR  THE  PATCH  IS 

»  THE  LOGICAL  OR  OF  THE  INDIVIDUAL  SWITCH  SETTINGS  DESIRED. 
I 
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COMPILER  BUILD  PILE  LISTINGS 


;  SWITCH 
NAME 


LI 


SWITCH 
SETTING 


VALUE  TO  'OR-  INTO  PATCH 


/LI : SRC  </Li:i)  000001  listing  of  source  program 

/LIIMAP  </Li:2)  000002   LISTING  OF  STORAGE  MAP 
/Li:COD  </Li:4)  000004   LISTING  OF  GENERATED  CODE 
/LItALL  </Li:7)  000007 

/-LI  000000 

000020   GENERATE  READ-ONLY  PSECTS 
000000 

000000   STATEMENT  TRACE  ON  ERRORS 
000200 

000400   ACCEPT  80  COLS.  OF  INPUT 
000000    (RATHER  THAN  72  +  SEQ  FIELD) 

001000   SPOOL  LISTING  OUTPUT 
000000 

002000   ENABLE  DIAGNOSTIC  MODE  FOR 
000000    COMPILER  CRASHES 

004000   ALLOCATE  2  WORDS  TO  INTEGER 
000000    WARS  BY  DEFAULT 

020000   COMPILE  DEBUG  LINES 
000000 

000000   VECTOR  ARRAYS 
040000 

000000   PRINT  WARNING  DIAGNOSTICS 
100000 

THE  VALUE  CALCULATED  FOR  THE  OPTIONS  DESIRED  MUST  BE  'OR'ED  WITH 
000040(8)  TO  YIELD  THE  VALUE  FOR  THE  PATCH  (I.E.t  THE  40(8)  BIT 
MUST  BE  SET  IN  THE  tSlDEF  WORD). 

THE  DEFAULT  VALUE.  001043(8) »  IS  THE  EQUIVALENT  OFt 
/LIM/-R0/SN/-EX/SP/-DI/-I4/-DE/VA/WR 

OBLPAT-FROOTUSIDEF  too  1043 

DEFAULT  SWITCH  SETTINGS  (SWITCH  WORD  2) 

THE  OLBPAT  WHICH  FOLLOWS  ALLOWS  THE  DEFAULT  SWITCH  SETTINGS  FOR 
THE  COMPILER  TO  BE  SET.   THE  VALUE  SPECIFIED  FOR  THE  PATCH  IS 
THE  LOGICAL  OR  OF  THE  INDIVIDUAL  SWITCH  SETTINGS  DESIRED. 


M 

/RO 

/-RO 

8N 

/SN 

/-SN 

EX 

/EX 

/-EX 

8P 

/SP 

/-SP 

BX 

/DI 

Z4 

/I4 

/-I4 

K 

/DE 

/-DE 

VA 

/VA 

/-VA 

UK 

/WR 

/-WR 
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COMPILBR  BUILD  PILE  LISTINGS 


SWITCH 

SWITCH 

NAHE 

SETTING 

CD 

/CDtTHR 

/cd:eae 

/cd:eis 

/CDtFIS 

LO 

/LO 

/-LO 

VALUE  TO  "OR*  INTO  PATCH 


000000   GENERATE  THREADED  CODE 
000002  GENERATE  EAE  INLINE  CODE 
000004   GENERATE  EIS  INLINE  CODE 
000014   GENERATE  FIS+EIS  INLINE  CODE 

000000   LOG  PROGRAM  UNIT  NAMES  ON  TERMINAL 
040000   DO  NOT  LOG  PROG  NAMES  ON  TERMINAL 

THE  VALUE  CALCULATED  FOR  THE  OPTIONS  DESIRED  MUST  BE  'OR'ED  WITH 

017700(8)  TO  YIELD  THE  VALUE  FOR  THE  PATCH  (I.E.,  THE  17700(8)  BITS 

must  be  set  in  the  ts2def  word). 

the  default  value,  017700(8),  is  the  equivalent  ofj 
/cd:thr/lo 

gblpat-froot : ♦s2def : 0 1 7700 

/ 
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COMPILER  BUILD  FILE  LISTINGS 


A. 5   VAX/VMS  UNDER  AME 

CSYSEXE]FOR.EXE/-CP=FORBLD/MP 

I 

>  FORTRAN  IV  COMPILER  TASK  BUILD  FILE 

) 

I  FOR  V02.5»  VAX/VMS  SYSTEMS 

9 

I 

}  TASK  NAME 

TASK=...FOR 

) 

)  BUILD  FOR  PARTITION  GEN>  WHICH  MUST  BE  AT  LEAST  8K 

) 

PAROGEN 

) 

}  SP  STACK  SIZE 

i    STACK  MUST  BE  AT  LEAST  150  UORDS 

) 

STACK-150 

I 

I  COMPILER  LOGICAL  UNIT  ASSIGNMENTS 


1  - 

COMMAND  INPUT 

2  - 

COMMAND  OUTPUT 

3  - 

.OBJ  OUTPUT 

4    - 

.LST  OUTPUT 

5  - 

.FTN  INPUT 

UNITS-5 
AS0>TI!i:2 

)  TASK  SIZE 

) 

I  THE  FOLLOWING  EXTTSK  SETS  THE  COMPILER  DEFAULT  SIZE  TO  28K  WORDS. 

»  IF  A  LARGER  COMPILER  IS  REQUIRED.  THE  EXTTSK  MAY  BE  INCREASED. 

f 

EXTTSK-18208 

I  ¥ 

I  NUMBER  OF  LINES  PER  LISTING  PAGE 

% 

I  THE  FOLLOWING  GBLPAT  CONTROLS  THE  NUMBER  OF  LINES  PER  LISTING  PAGE, 

%    THE  VALUE  SPECIFIED  FOR  THE  PATCH  IS  THE  NUMBER  OF  LINES 

>  PER  PAGE  DESIRED*  MINUS  1. 

I  DEFAULT  VALUE  IS  000070(8)  =  56.  »  57.  LINES  PER  PAGE. 

GBLPAT-FROOT : tLNMAX : 000070 

» 

I  DEFAULT  SWITCH  SETTINGS  (SWITCH  WORD  1) 

I 

I  THE  OLBPAT  WHICH  FOLLOWS  ALLOWS  THE  DEFAULT  SWITCH  SETTINGS  FOR 

»  THE  COMPILER  TO  BE  SET.   THE  VALUE  SPECIFIED  FOR  THE  PATCH  IS 

»  THE  LOGICAL  OR  OF  THE  INDIVIDUAL  SWITCH  SETTINGS  DESIRED. 

I 
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COMPILER  BUILD  f2^E  LISTINGS 


SWITCH 
NAHE 


Lt 


SWITCH 
SETTING 


VALUE  TO  'OR"  INTO  PATCH 


/LI : SRC  (/Li:i)  000001  listing  of  source  program 

/LIJMAP  (/Ll:2)  000002  LISTING  OF  STORAGF  HAP 

/LirCOD  (/LIM)  000004  LISTING  OF  GENERATED  CODE 

/LI : ALL  (/Li:7)  000007 


/-LI 


RO 

/RO 

/-RO 

m» 

/SN 

/-SN 

ex 

/EX 

/-EX 

» 

/SP 

/-SP 

BX 

/DI 

Z4 

/I4 

/-I4 

DC 

/DE 

/-DE 

VA 

/VA 

/-VA 

WR 

/WR 

/-WR 

000000 

000020   GENERATE  READ-ONLY  PSECTS 
000000 


000000 
000200 

000400 
000000 


o.ATEMENT  TRACE  ON  ERRORS 


ACCEPT  80  COLS.  OF  INPUT 
(RATHER  THAN  72  +  SEQ  FIELD) 


001000   SPOOL  LISTING  OUTPUT 
000000 

002000   ENABLE  DIAGNOSTIC  MODE  FOR 
000000    COMPILER  CRASHES 

004000   ALLOCATE  2  WORDS  TO    INTEGER 
000000    VARS  BY  DEFAULT 

020000   COMPILE  DEBUG  LINES 
000000 

000000   VECTOR  ARRAYS 
040000 

000000   PRINT  WARNING  DIAGNOSTICS 
100000 

THE  VALUE  CALCULATED  FOR  THE  OPTIONS  DESIRED  MUST  DE  'OR'ED  WITH 
000040(8)  TO  YIELD  THE  VALUE  FOR  THE  PATCH  (I.E.,  THE  40(8)  BIT 
MUST  BE  SET  IN  THE  tSlDEF  WORD). 

THE  DEFAULT  VALUE »  000043(8).  IS  THE  EQUIVALENT  OF: 
/Li:3/-R0/SN/-EX/-SP/-DI/-I4/-DE/VA/WR 

OBLPAT-FROOT : tSlDEF : 000043 


A-I5 


APPENDIX  B 
FORTRAN  IV  V2.5  RBLBA8B  NOTES 


The  FORTRAN  IV  V2.5  compiler  has  the  following  restrictions;  these 
restrictions  represent  highly  contextual  problems.  Illustrated  here  by 
specific  examples.  Where  feasible,  patches  and  autopatches  will  be 
supplied  In  the  future  to  lift  these  restrictions.  A  workaround  is 
suggested  for  each  restriction. 


1. 


Problem 
in-line 


statement: 
code  for  the 


the   compiler   will 
following  program: 


generate   Incorrect 


BYTE  L 
I-L/10 
J-L-I*10 
END 

Cause:      the    register-allocation   phase 
the  wrong    register    for    the   division. 

Workaround : 


of    the   compiler    assigns 


BYTE    L 

J-L-L/10*10 

END 


2. 


Problem 
in-line 


statement : 
code    for   the 


the      compiler     will 
following   program: 


generate      incorrect 


10 


DIMENSION    A(10).K(10),L(10),M(10) 

COMMON    A,K,L,M 

DO    10    I-1,N 

J-I+Kl 

A(I)-A(J) 

K(I)-K(J) 

L{I)-L(J) 

«{I)-M(J) 

CONTINUE 

END 


Cause:  the  code-generation  phase  of  the  compiler  as'ilgns  to 
a  compiler  temporary  a  register  already  In  use,  without 
saving    the    register's  contents. 

Works  I ound  t 


DIMENSION   A(10) ,K(10) ,L(10) ,M(10) 
COMMON    A,K,L,M 
DO    10    I-1,N 
J-I+Kl 
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FORTRAN  IV  V2.5  R8LBASB  NOTES 


K(I)-K(J) 
L(I)-L(J) 
M(I)-M(J) 
A(I)-A(J) 
10  CONTINUE 
END 

^'   »""**;  Statement:   the  compiler  will  abort   if  the   in-line 
FIS  code  option  is  selected  for  the  following  program: 

SUBROUTINE  X(D) 

COMMON  C(5) ,S(5) 

DIMENSIc'  D{5) 

DO  10  i>l,N 

C(I)-S(i) 

DO  20  J-1,I 
20  D(K)-D{J) 
10  CONTINUE 

K-K/2 

D(l)-D(2) 

RETURN 

END 

Workaround:   put  array  D  in  COMMON. 

DO  10  1-1,3000*1000 
10  CONTINUE 
END 

cause:   the  loop-optimization  phase  of  the  compiler  tries   to 
evaluate  the  trip  count  but  fails  due  to  overflow. 

Workaround:   avoid  using  illegal  values  as  DO  parameters. 

5,   Problem   statement:    the   comoilAr  ui  i  i   iaa..^   *.k^ 

•MISSING  DELIMITER  IN  EXPRElir!ii"cr"iii  foUcWnrpro,";?' 

WRITE(5,100)  ((I-N)/N)*2 
100  F0RMAT(I2) 
END 

incorrectly. ^^°  expression   analyzer  parses   the  expression 

Workaround: 

WRITE(5,!00)  2*((I-N)/N) 
100  P0RMAT(I2) 
END 

6.   Problem  statement:   inconsistency   in   a   logical   operation: 
<uu  m  the  following  program: 

BYTE  B 

DATA  B/"200/ 
I-B.AND."377 

J-"376.AND.B 
END 
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FORTRAN  IV  V2.5  RELEASE  MOTES 


illV  i"/0«TRAN  IV,  if  the  second  operand  of  an  ope 
h!  ^K  ^  !  constant,  the  data  type  of  the  operand  is  d 
sLr«^  t^'^l  ""^IJ^  ^^?  ^^"*^  operand  of  the  oper 
libit  J  ,  pvJc^^**  ^"*«ble,  -377  is  entered  into  the 
table  as  a  BYTE  constant  and  the  opeiaiion  is  carried  o 
byte   level,  and  when  the  result  of  the  operation  is  as 

aLhAi   .  w,^^^"'®'**^®"'^**^-   However,  "376  is  entered  in 
symbol   table  as  an   integer  constant;    therefore, 
sign-extended   when   loaded   into   a   regi  .er   Lefore 
operation.  ^        "ci-ote 

Workaround:   assign  "377  to  an   nteger  variable. 
II.   OTS  RESTRICTION 


ation 

jided 

ation. 

symbol 

ut   at 

signed 

to  the 

B   is 

the 


Library  subroutine  ERRSNS  returns  zero   values   for 
parameters  if  the  error  is  not  an  file  open  error. 


the   last   three 


III.   MISCELLANEOUS 

Calling  the  roRTRAN  compiler  using  MCR  in  the  following   examole  will 
cause  a  null-length  object  file  to  be  created:  example  wixl 

MCR  FOR  ABC.FTN 

or 

MCR>  FOR  ABC.FTN 

Using  an  equal  sign  in  front  of  the  source  file  will  avoid  this: 
MCR  FOR  =ABC.FTN 

or 
MCR>  FOR  "ABC.FTN 


• 
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READER'S  COMMENTS 


NOTE:   This  form  is  for  document  comments  only.   DIGITAL  will 
use  comments  submitted  on  this  form  at  the  company's 
discretion.   If  you  require  a  written  reply  and  are 
eligible  to  receive  one  under  Software  Performance 
Report  (SPR)  service,  submit  your  comments  on  an  SPR 
form. 

Did  you  find  this  manual  understandable,  usable,  and  well-organized? 
Please  make  suggestions  for  improvement. 


c 


Did  you  find  errors  in  this  manual? 
page  number. 


If  so,  specify  the  error  and  the 
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Please  indicate  the  type  of  reader  that  you  most  nearly  represent. 
I  I  Assembly  language  programmer 


[~}  Higher- level  language  programmer 

I  I  Occasional  programmer  (experienced) 

I  I  User  with  little  programming  experience 

I  I  Student  programmer 

r~l  Other  (please  specify) 


Name. 


Date. 


Organization. 


Street. 


City. 


State 


Zip  Code. 

or 
Country 


—   —    —    Do  Not  Tear  •  Fold  Here  and  Tipe 


BUSINESS  REPLY  MAIL 

FIRST  CLASS  PERMIT  N0.33  MAYNARD  MASS. 


POSTAGE  WILL  BE  PAID  BY  ADDRESSEE 


BSSG  PUBLICATIONS     TW/A14 
DIGITAL  EQUIPMENT  CORPORATION 
1925  ANDOVER  STREET 
TEWKSBURY,  MASSACHUSETTS     01876 


No  Postage 

Necessary 

if  Mailed  in  the 

United  States 


—  Do  Not  Tear  -  Fold  Here 


mi 

I 

& 

s 


a 


